home *** CD-ROM | disk | FTP | other *** search
/ Macwelt 1 / Macwelt DVD 1.toast / Web-Publishing / HTML-Editoren / Alpha ƒ / Help / Version Control Help < prev    next >
Encoding:
Text File  |  2000-10-30  |  3.2 KB  |  85 lines
  1.  
  2.             Version Control
  3.  
  4.  
  5.                                               created: 97-03-03 11.44.50
  6.                                           last update: 08/08/2000 {15:09:57 PM}
  7.  
  8. Author:    Vince Darley
  9. E-mail:    <vince@santafe.edu>
  10.   mail:    317 Paseo de Peralta, Santa Fe, NM 87501, USA
  11.    www:    <http://www.santafe.edu/~vince/>
  12.  
  13.  
  14.            Introduction
  15.  
  16. The core AlphaTcl library now incorporates the rudiments of a general
  17. version control package.  The goal of this is to allow you to open,
  18. check out, check in, diff, merge,...  files within Alpha.  The version
  19. control support is designed to allow you to use many different version
  20. control packages (cvs, voodoo, perforce, etc) at the same time (a
  21. particular version control package is associated with a given set of
  22. files, so any one file must of course only be under one kind of version
  23. control).
  24.  
  25. In Alpha 8 or Alphatk, each window has a version control popup-menu,
  26. towards the top right corner, above the marks menu.  In Alpha 7 you
  27. have to activate the 'Version Control Menu' package which gives you
  28. a menu in the main menubar from which to access these functions.
  29.  
  30. Packages are provided to plug in to the general vc system.  Currently 
  31. four such packages are available: vcPerforce, vcCvs, vcVoodoo and 
  32. vcLocal.  This last package is basically a means to keep two file
  33. trees, a 'repository' and a working-tree.  Files are edited in the
  34. working tree, and checked in/out of the repository tree.
  35.  
  36.            VC setup
  37.  
  38. The VC code needs to know what version control system to use for
  39. a given file.  The way you do this in Alpha is via filesets.  Each
  40. fileset you define can have various additional pieces of information
  41. attached to it.  One of these, provided you have activated the 'Vcs'
  42. feature, is the version control system.  After activating the Vcs
  43. feature, simply go to the 'Edit Filesets' dialog and you will notice
  44. that each fileset has an associated popup menu from which you can
  45. select Cvs, Perforce, Voodoo etc.
  46.  
  47. If you don't already have a fileset which includes the files you want 
  48. to use a version control system on, you need to create one.  If you'd 
  49. like the files to be in the Fileset Menu, you probably should use a
  50. 'From Hierarchy' or 'From Directory' fileset.  If you'd simply like
  51. Alpha to know about the fileset ('behind the scenes', as it were),
  52. then a 'Recurse In' fileset is probably best.  See "Filesets Help" for
  53. more information.
  54.  
  55. Once you have a fileset associated with a given file, Alpha
  56. automatically places relevant version control actions in the popup
  57. menu in each window (for Alpha 7.x, this popup does not exist.  In
  58. this case you have to use the less sophisticated global Version
  59. Control Menu).
  60.  
  61.            VC operations
  62.  
  63. Currently you may carry out any of the following operations:
  64.  
  65.     add 
  66.     checkIn 
  67.     undoCheckout 
  68.     makeWritable 
  69.     checkOut
  70.     refetchReadOnly 
  71.     fetchReadOnly
  72.     showDifferences
  73.     
  74. Although some may not be 100% implemented yet.
  75.     
  76. to be continued...
  77.  
  78.            VC limitations
  79.  
  80. Most of the current plug-ins cannot be used to setup a particular
  81. version control system; they rely on a pre-existing configuration
  82. (for the vc server, password, etc).  Hence you will probably have to
  83. use a cvs client, perforce client etc to configure the system before
  84. Alpha will be able to use it effectively.
  85.